home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / 0utils.lha / 0Utils / Tackon.doc < prev    next >
Text File  |  1995-09-05  |  2KB  |  82 lines
  1.  
  2.  
  3.  
  4.     NAME
  5.     Tackon
  6.  
  7.     SYNOPSIS
  8.     Tackon -  join path, filename and suffix  - Requires v37
  9.  
  10.     INPUTS
  11.     "PATH,NAME/A,SUFFIX"
  12.  
  13.     DESCRIPTION
  14.  
  15.     Tackon gets a filename and perhaps a pathname and a
  16.     suffix and creates a new filename out of them.
  17.  
  18.     To add correctly filename to pathname we use AmigaDOS.
  19.  
  20.     If the suffix starts with a "." or "_" (any non
  21.     alnum character), it is directly appended to the
  22.     full filename;
  23.     if suffix starts with an alphanumeric char,
  24.     a "." is prepended.
  25.  
  26.     The resulting string is sent to STDOUT
  27.  
  28.      RESULT
  29.     a filename created with the inputs.
  30.     
  31.  
  32.     
  33.         
  34.  
  35.     NOTES
  36.     * CLI - only
  37.  
  38.     * should compile with SAS-C
  39.     
  40.  
  41.     BUGS
  42.  
  43.     * there is no check (yet), if suffix is itself a path
  44.     * the resulting filename must not be bigger than 256 chars
  45.     there is a strange behaviour if compiled w/ DICE;
  46.     * I cannot say why, but If You do not specify
  47.     each input-slot, You will get a Enforcer-Hits;
  48.     for that reason, I'll distribute Chris' SAS-executable
  49.     
  50.  
  51.     EXAMPLES
  52.  
  53.     >Tackon x: a:b _c
  54.     a:b_c
  55.  
  56.     >Tackon x:a b c
  57.     x:a/b.c
  58.  
  59.     > tackon xx yy zz
  60.     xx/yy.zz
  61.  
  62.     > tackon xx :yy -zz
  63.     :yy-zz
  64.     
  65.  
  66.     HISTORY
  67.  
  68.     01-08-93 b_noll created
  69.     20-02-95 b_noll restructured source, removed mstrcpy
  70.     21-02-95 b_noll added version/format-prefix/offset
  71.     27-02-95 b_noll removed an Enforcer Hit (huch!)
  72.     20-03-95 b_noll added args diagnostics
  73.     20-03-95 b_noll fixed crash, if resultstring was too large,
  74.             always returned RETURN_WARN
  75.     19-08-95 b_noll created .data file
  76.     
  77.  
  78.     AUTHOR
  79.     Bernd Noll, Brunnenstrasse 55, D-67661 Kaiserslautern
  80.     noll@student.uni-kl.de
  81.  
  82.